home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / misc / CritturCauldrn.lzh / Crittur_Cauldron.doc < prev    next >
Text File  |  1993-10-15  |  9KB  |  221 lines
  1.  
  2.                           Crittur Cauldron
  3.                           by Thom Robertson
  4.  
  5.  
  6. INTRODUCTION
  7.  
  8. Thank you for reading this, the documentation for Crittur Cauldron.
  9. Crittur Cauldron is a simple simulation of life.  Unlike games like "life", which
  10. are examples of cellular automata, Crittur Cauldron models life as individual
  11. critters (plants, herbivores, and carnivores), and keeps track of their birth,
  12. life, and death.
  13.  
  14. Crittur Cauldron is not really a game so much as it is a thinking toy.  Each
  15. time you run Crittur Cauldron, a world is created, and one plant (hereafter known
  16. as Eve) is created.  She multiplies, and her children do likewise.  Some births
  17. can be mutations, changing the speed of the species, the distance the plant can
  18. throw her seeds, and sometimes fundamental changes from plant to herbivore and
  19. from herbivore to carnivore.
  20.  
  21. Because of a small number of random elements, Crittur Cauldron is
  22. different each time you run it, but the laws of natural selection control the
  23. ultimate destiny of the world.  Changing most of the fundamental aspects
  24. governing the laws of the world can be done simply by editing a configuration
  25. text file.
  26.  
  27. Some worlds will have short, brutal lives, while others can settle down into a
  28. self-sustaining state.  Either way, Crittur Cauldron is sure
  29. to provide many hours of facinating and thought-provoking fun.
  30.  
  31.  
  32. HOW TO USE
  33.  
  34. Crittur Cauldron should be a set of files together in the same directory.
  35. Check to make sure you have:
  36.  
  37. CC.IFF
  38. ccdata.txt
  39. Crittur_Cauldron.doc
  40. CC_order_form.txt
  41. Crittur_Cauldron.info
  42. Crittur_Cauldron
  43.  
  44. Execute "Crittur_Cauldron" from the Workbench by clicking its icon, or from the
  45. CLI by typing the name.
  46.  
  47. Crittur Cauldron will appear, and since it starts right away, you may not be able
  48. to see the
  49. green "A" character in the middle of the display (Eve), because many other "A"s
  50. and "B"s (her children) will be spreading out from the center.  Some plants
  51. (the green letters) will have different letter designations.  This means that
  52. they are a seperate species, mutated from Eve's original genetic code.
  53.  
  54. Sooner or later, you will see a blue letter.  Blue letters are herbivores, who
  55. begin happily munching on green letters and giving birth to more blue letters.
  56. One of THOSE may mutate into a red letter, which means it's a carnivore.
  57.  
  58. The genome of a critter (traits it shares with others of its species) is very
  59. simple, with three variables:
  60.  
  61. Type  - whether it's plant, herbivore, or carnivore.
  62.  
  63. Speed - how many steps it can take towards food each game cycle (plants can't
  64.         move, even when they have this trait).
  65.  
  66. Birth Distance - the maximum range a crittur may be borne away from its parent.
  67.                  This simulates plant seeds that scatter in the wind, or move
  68.                  through other methods.  Herbivores and carnivores have this
  69.                  trait, too.  It is interesting to see whether natural selection
  70.                  breeds this out of them.
  71.  
  72. The text at the lower right of the screen shows the last mutation occuring.
  73. This text is updated everytime a mutation occurs, even if the mutation results
  74. in a species that already exists.
  75.  
  76. When you get tired of watching this world, hit any key, wait for the play
  77. area to go black, and hit any key again to exit from Crittur Cauldron.
  78. If the play area goes black of it's own occord, this means that the world was
  79. unstable and didn't survive.  Press any key to exit.
  80.  
  81.  
  82. WHAT IT DOES
  83.  
  84. Crittur Cauldron makes a simple but honest attempt to model
  85. life, it's births, deaths, and principles.  Starting with Eve, the program runs
  86. an endless cycle, keeping track of every creature.
  87.  
  88. Each creature is modeled with this information:
  89.  
  90. Type  - whether it's plant, herbivore, or carnivore.
  91.  
  92. Speed - how many steps it can take towards food each game cycle (plants can't
  93.         move, even when they have this trait).
  94.  
  95. Birth Distance - the maximum range a crittur may be borne away from its parent.
  96.  
  97. Letter - the character that represents it on the screen.  This character, like
  98.          most other traits, is inherited from the creature's parent, UNLESS
  99.          the child is borne with a mutation.  In that case, the child recieves
  100.          the same letter as any other creatures with the same genotype that
  101.          are currently alive.  If the mutant child's genotype is truly unique,
  102.          a new letter will be assigned to it.
  103.  
  104. Age - the number of cycles this creature has been alive.  All creatures die of
  105.       old age in the same way at approximately the same age.
  106.  
  107. Energy - an abstract measure of how much food has been eaten vs. the energy
  108.          cost of keeping the creature alive.  When this drops to 0 or below,
  109.          the creature dies. Plants get a set amount of energy from the sun
  110.          every cycle.  Other types ingest all of the energy of their meal when
  111.          they eat it.
  112.  
  113. X and Y - the position of the creature. Creatures can occupy the same space,
  114.           but if plants share the same spot, they also share its sunlight,
  115.           making them weak and sickly.
  116.  
  117.  
  118. Each cycle, every creature collects its energy.  The plants soak up sunlight,
  119. and the herbivores and carnivores move to their prey and ingest them.
  120.  
  121. Next, every creature is assessed a "cost of living", according to a simple
  122. formula based on it's genotype.  This formula is:
  123.  
  124. cost = (speed / speed coefficient) + 
  125.        ((age / age coefficient))**2 +
  126.        (birth range / birth range coefficient) + 1
  127.  
  128. Speed coefficient, age coefficient, and birth range coefficients are set in the
  129. ccdata.txt file.
  130.  
  131. As you can see, this formula puts limits on the speed, age, and birth range
  132. of the creature.  Age, in particular, is coded so that, as the creature ages,
  133. it becomes harder and harder to survive.
  134.  
  135. Any creature who's energy drops to 0 or below dies and is removed from the
  136. display. 
  137.  
  138. Next, any creature who has collected enough energy gives birth.  The child is
  139. created, given some of the energy of it's parent, and placed in a random
  140. direction at a distance from the parent.  How far away it gets is determined
  141. by the parent's birth distance genome, and a random number.  This means that
  142. sometimes the child can end up in the same spot as the parent or another
  143. creature, with bad effects if both happen to be plants.
  144.  
  145. To give birth, creatures have to collect as much energy as:
  146.  
  147. (life cost of the species) * (birth coefficient)
  148.  
  149. Once a child is born, it gets (parent's energy) / (birth energy coefficient)
  150. worth of energy to start with.  Then the parent's energy drops to one cycle's
  151. worth of life energy for it's genotype.
  152.  
  153. The birth and birth energy coefficients are defined in the ccdata.txt file,
  154. which you can modify.
  155.  
  156. Then the cycle begins again.
  157.  
  158.  
  159.  
  160. EDITING THE CCDATA.TXT FILE
  161.  
  162. The ccdata.txt file is a simple text file containing the various values you can
  163. modify about the world.  When Crittur Cauldron is run, this
  164. file is read in, and its values are used for the the various calculations.
  165.  
  166. The file should not be renamed something different or put in a different
  167. directory if you expect Crittur Cauldron to find and use it.
  168. However, after finding a set of values that provide interesting results, you
  169. may want to keep a copy of that ccdata.txt file in another directory, so that
  170. you don't loose those particular settings and can share them with friends or
  171. students.
  172.  
  173. You can use any text editor or word processor, as long as the editor saves the
  174. file as simple ASCII text, without any special control codes.  My parser might
  175. actually parse such codes out, but then again, it may not.  I don't know.
  176.  
  177. The file is organized as a series of numbers, each separated by a semicolon.
  178. Also, lines in the file that BEGIN with a pound symbol (#) are comments, and
  179. such lines are ignored.  Do not remove, add, or change the order of the numbers,
  180. lest you get funny results.  Also, all comment lines MUST begin, at the FIRST
  181. character column, with a pound symbol (#).
  182.  
  183. For more information about which numbers do what, refer to the ccdata.txt file's
  184. comment lines.
  185.  
  186.  
  187. CONCLUSION
  188.  
  189. Crittur Cauldron was conceived and written by me, Thom Robertson.  I reserve
  190. all rights worldwide and claim Crittur Cauldron, name and concept,
  191.  
  192.    Copyright(c) 1993  by Thom Robertson.
  193.  
  194. Crittur Cauldron is shareware.  If you like it, get a kick out of it, use it as
  195. a teaching tool, or simply like fiddling with it and watching the results,
  196. please register.
  197.  
  198. It costs just $5.00, and entitles you to bug fixes and minor upgrades.  I
  199. intend to create major upgrades, too, and registered owners will get discounts
  200. on these.
  201.  
  202. Register by sending your name and address, along with $5.00 US dollars in
  203. check or money order, to:
  204.  
  205. Crittur Cauldron Registration
  206. c/o Thom Robertson
  207. 803-C Autumn Circle
  208. College Station, TX 77840
  209.  
  210. When registering, you may also purchase the Amiga Lattice C source code to
  211. Crittur Cauldron for an extra $10.00 US dollars.  This purchase gives you the right to
  212. modify and use your copy of the source code in any way you please, for no
  213. additional fee.  The only restriction is that you do not use the code to produce
  214. a product that would compete commercially with any version of Crittur
  215. Cauldron. 
  216.  
  217. Please make the check or money order payable to me, Thom Robertson.
  218.  
  219. Thank you.  Have fun!
  220.  
  221.